home *** CD-ROM | disk | FTP | other *** search
/ USA Bestseller / USA BESTSELLER Vol 1-95 (Hepp-Computer)(1995).iso / e004 / updat55.doc < prev    next >
Text File  |  1994-10-12  |  19KB  |  524 lines
  1.  
  2.  
  3.  
  4.                                   JP Software
  5.  
  6.                            4DOS Update Documentation
  7.  
  8.                         Version 5.5 -- October 12, 1994
  9.  
  10.    Copyright 1988 - 1994, JP Software Inc., All Rights Reserved.  Published
  11.    by JP Software Inc., P.O. Box 1470, E. Arlington, MA 02174 USA, (617)
  12.    646-3975.
  13.  
  14.  
  15.    There are dozens of new features in this latest release of 4DOS!  Check
  16.    through this file for a comprehensive list of what's changed since
  17.    version 5.0
  18.  
  19.    This file does not explain how to use the new features.  Be sure to
  20.    check the online help, ASCII Reference Manual, or printed Addendum
  21.    Manual for complete details on each new feature.
  22.  
  23.    Some of the descriptions below may be more detailed than you need; if
  24.    you aren't using a feature, feel free to skip to the next item.  If you
  25.    are new to 4DOS with version 5.5, you can skip this file entirely, and
  26.    begin with the 4DOS Introduction and Installation Guide.
  27.  
  28.    This file is divided into the following sections:
  29.  
  30.           General Features and Enhancements
  31.           Startup, Initialization, and 4DOS.INI
  32.           Command Line Editing and History
  33.           Aliases
  34.           Command Changes and Enhancements
  35.           Variables and Variable Functions
  36.           Technical and Compatibility Enhancements
  37.           Bugs Fixed
  38.  
  39.    Significant new features and those which affect most users are marked
  40.    with "**" in the lists below.  Other items discuss smaller or more
  41.    technical changes.
  42.  
  43.    This file is formatted at 58 lines per page, and contains form feeds and
  44.    page footers.  It can be viewed with a file viewer such as the 4DOS LIST
  45.    command, or printed on most PC printers using the command:
  46.  
  47.                   copy updat55.doc prn
  48.  
  49.    Printing it with a program that formats the pages is not likely to work
  50.    due to the formatting included in the file.
  51.  
  52.  
  53.  
  54.  
  55.                                                                (10/94-5.5A)
  56.  
  57.  
  58.  
  59.    4DOS 5.5  [10-12-94]           UPDAT55.DOC                        page 1
  60.  
  61.  
  62.  
  63.                              4DOS 5.5 Change List
  64.  
  65.  
  66.    General Features and Enhancements
  67.    ---------------------------------
  68.  
  69.    => **  The maximum file description length (set with the DescriptionMax
  70.           directive in the .INI file) has been increased to 511 characters.
  71.  
  72.    => **  Colors can now be specified as either digits (0-15) or the color
  73.           name, i.e. "COLOR 15 on 1" for bright white on blue.  This should
  74.           help those who are running out of room for ColorDir
  75.           specifications.  The colors are:
  76.  
  77.               0:  Black               8:   Gray
  78.               1:  Blue                9:   Bright blue
  79.               2:  Green               10:  Bright green
  80.               3:  Cyan                11:  Bright cyan
  81.               4:  Red                 12:  Bright red
  82.               5:  Magenta             13:  Bright magenta
  83.               6:  Brown               14:  Yellow
  84.               7:  White               15:  Bright white
  85.  
  86.    =>     @ATTRIB and the /A:xxx switches on all commands will ignore
  87.           underlines in the attribute string, for example "/A:R_S" is a
  88.           valid switch for the commands which support /A.  This allows you
  89.           to use the results returned by @ATTRIB in a command or another
  90.           call to @ATTRIB.
  91.  
  92.    =>     Added more complete support for decimal and negative numbers in
  93.           DO and IF / IFF comparisons.
  94.  
  95.    =>     Wildcard matching supports "[]" to mean "match only if nothing's
  96.           there."  This is useful for things like:
  97.  
  98.                   dir /i"[]" *.btm
  99.  
  100.           to display only the .BTM files that do NOT have a description.
  101.  
  102.  
  103.    Startup, Initialization, and 4DOS.INI
  104.    -------------------------------------
  105.  
  106.    =>     There is a new startup switch, /LD, to force a local directory
  107.           history.
  108.  
  109.    =>     There are a number of new .INI file directives:
  110.  
  111.               DescriptionName = File:  Filename to use for file
  112.               descriptions, defaults to DESCRIPT.ION.  This is intended
  113.  
  114.  
  115.  
  116.  
  117.    4DOS 5.5  [10-12-94]           UPDAT55.DOC                        page 2
  118.  
  119.  
  120.               primarily for BBS sysops who want to use FILES.BBS for file
  121.               descriptions.
  122.  
  123.               DirHistory = nnnn (256):  Size of the directory history in
  124.               bytes, from 128 to 2048.
  125.  
  126.               EvalMax = nnnn (8):  Maximum number of digits after the
  127.               decimal point in values returned by @EVAL (0-8).
  128.  
  129.               EvalMin = nnnn (0):  Minimum number of digits after the
  130.               decimal point in values returned by @EVAL (0-8).  EvalMin
  131.               will be ignored if it is larger than EvalMax.
  132.  
  133.               LocalDirHistory = [Yes|No]:  Sets local or global directory
  134.               history.  The default is Yes for 4DOS, No for 4OS2 and
  135.               4DOS/NT.
  136.  
  137.               SDFlush = Yes | NO.  If set to Yes, 4DOS will instruct
  138.               SMARTDRV to flush write-behind buffers to disk before the
  139.               4DOS prompt is displayed.  Some versions of other cache
  140.               programs (e.g. Norton NCACHE) may also respond to
  141.               SDFlush = Yes.
  142.  
  143.               UMBDirHistory = Yes | NO | 1 | 2 | ... | 8:  Loads the global
  144.               directory history into a UMB or a specific UMB region, rather
  145.               than into low memory.
  146.  
  147.  
  148.    Command Line Editing and History
  149.    --------------------------------
  150.  
  151.    => **  Directory histories are inherited, and can be global, like
  152.           aliases and command history (also see the new LocalDirHistory
  153.           directive in 4DOS.INI).
  154.  
  155.    => **  A Ctrl-Enter while scrolling through command history at the
  156.           prompt will now copy the line to the end of the history list,
  157.           even if you don't alter it.  This allows you to force lines to
  158.           the end of the list for easier recall.
  159.  
  160.    =>     You can prefix a command with either @* or *@ to both disable
  161.           aliases and prevent the command from being stored in the history
  162.           (previously only @* was supported).
  163.  
  164.  
  165.    Aliases and Batch Files
  166.    -----------------------
  167.  
  168.    => **  Errors in batch files display the batch file name and the line
  169.           number where the error occurred.  The first line in the file is
  170.           numbered 1.
  171.  
  172.  
  173.  
  174.  
  175.    4DOS 5.5  [10-12-94]           UPDAT55.DOC                        page 3
  176.  
  177.  
  178.    =>     Added ESC as a synonym for R(est) when you're single-stepping
  179.           through batch files with SETDOS /Y1.
  180.  
  181.  
  182.    Command Changes and Enhancements
  183.    --------------------------------
  184.  
  185.    => **  ATTRIB, COPY, DEL, DESCRIBE, LIST, MOVE, REN, and TYPE all
  186.           support the /A:[[-]rhsda] switch (using same syntax as in DIR). 
  187.           This allows you to process files in a variety of ways based on
  188.           their attributes.
  189.  
  190.    =>     ?:  If you use arguments with a "?" command, it will prompt for
  191.           whether to execute another command.
  192.  
  193.    =>     DELAY has been changed so it does not consume significant CPU
  194.           time during the delay period when running under a multitasker.
  195.  
  196.    =>     DIR has several changes:
  197.  
  198.               * Summary totals for files and directories are now listed
  199.               separately.
  200.  
  201.               * /B strips trailing spaces to avoid extra characters in
  202.               redirected output files.
  203.  
  204.               * /T will no longer suppress the display of descriptions;
  205.               instead, descriptions will be displayed after the attributes.
  206.  
  207.    =>     DRAWBOX supports BRIght FILL colors.
  208.  
  209.    => **  FFIND is a new command for quickly finding files or text within
  210.           files.  It can search anything from a single directory to all the
  211.           disks on your system in a single command, supports wildcards in
  212.           the search text, and offers a range of options to customize the
  213.           search.
  214.  
  215.    =>     FOR has a new /H switch to skip the "." and ".." directory
  216.           entries in a wildcard scan.
  217.  
  218.    =>     FOR supports use of the "/" to split off the first character of a
  219.           string, as COMMAND.COM does.  The new /D switch disables this
  220.           feature.
  221.  
  222.    =>     INKEY and INPUT have two new switches.  /X skips printing a CR/LF
  223.           after echoing the key or line typed by the user; /D allows only
  224.           digits (0-9) in the input.
  225.  
  226.    =>     INPUT has a new /N switch to disable the display color specified
  227.           by InputColor in the .INI file, and use the default display
  228.           colors.
  229.  
  230.  
  231.  
  232.  
  233.    4DOS 5.5  [10-12-94]           UPDAT55.DOC                        page 4
  234.  
  235.  
  236.    =>     KEYSTACK automatically inserts scan codes as well as ASCII codes. 
  237.           This replaces the cumbersome approach of multiplying the scan
  238.           code by 256 and adding it to the ASCII code.
  239.  
  240.    => **  LIST supports several new options:
  241.  
  242.               * Wildcards can be used in text search strings.  For example
  243.               you can use "to*day" as a search string to find the next line
  244.               with "to" followed by "day" later on the same line, or
  245.               "[14]01" to find the next line containing either "101" or
  246.               "401".  You can disable wildcard searches by prefixing the
  247.               search string with a single backquote [`].
  248.  
  249.               * Pressing "B" (for "back") displays the previous file.  You
  250.               can go all the way back to the first file.
  251.  
  252.               * The file description (if any) is displayed in the "Info"
  253.               box brought up with the "I" key.
  254.  
  255.               * The "G" (goto) command in hex mode prompts for a hex offset
  256.               rather than a line number.
  257.  
  258.               * The P(rint) option asks if you want to print the entire
  259.               file or the current page only.
  260.  
  261.    =>     LOG displays the log file name if you don't enter any arguments.
  262.  
  263.    =>     MOVE has two new switches:  /M only moves files with the archive
  264.           attribute bit set; /V checks that the data is physically
  265.           accessible after the MOVE (like COPY /V).  Also MOVE is slightly
  266.           faster in cases where the target file already exists.
  267.  
  268.    =>     ON ERROR will no longer display the error message before
  269.           executing the specified command.
  270.  
  271.    =>     PROMPT has two new prompt characters, $m and $M, to display the
  272.           time in hours and minutes only.  $m displays in 24-hour format;
  273.           $M uses the default country format.  These are similar to $t and
  274.           $T, but do not display seconds.
  275.  
  276.    =>     REM can create an empty file with the syntax "REM > file";
  277.           previously this did not work if there was a space after "REM".
  278.  
  279.    => **  SELECT has three enhancements:
  280.  
  281.               * The L key will call LIST with the current highlighted
  282.               filename.  This allows you to view a file before deciding
  283.               whether to select it.  Exiting LIST will return you to the
  284.               saved position in SELECT.
  285.  
  286.               * The left and right cursor keys will scroll descriptions
  287.               which are longer than the current screen width.
  288.  
  289.  
  290.  
  291.    4DOS 5.5  [10-12-94]           UPDAT55.DOC                        page 5
  292.  
  293.  
  294.               * The new /H switch will hide the "." and ".." directory
  295.               entries.
  296.  
  297.    =>     SETDOS has three changes:
  298.  
  299.               * /B can be used in a batch file to change the bright/blink
  300.               bit.  Previously the bright / blink state was only toggled
  301.               when the prompt was displayed.
  302.  
  303.               * The new /Fx.y switch sets the minimum and maximum decimal
  304.               precision in @EVAL.  Also see @EVAL and the new EvalMax and
  305.               EvalMin directives in the .INI file.
  306.  
  307.               * You can disable all cursor shape changes normally made by
  308.               the command processor by setting either of the /S arguments
  309.               to -1.  This is primarily intended for those with laptops who
  310.               have other programs controlling the cursor shape.
  311.  
  312.    =>     TEE has been rewritten and is much faster.
  313.  
  314.  
  315.    Variables and Variable Functions
  316.    --------------------------------
  317.  
  318.    Enhancements to Existing Variable Functions:
  319.  
  320.    =>     @ATTRIB:  If you only specify the filename, @ATTRIB will now
  321.           return the attributes for that file.  The format is the same as
  322.           that for the ATTRIB and DIR commands: a five-character string of
  323.           the form "RHSAD", with any non-existing attribute bits replaced
  324.           by an underline (e.g. R__A_).
  325.  
  326.    => **  @EVAL now supports integer exponentiation with the "**" operator,
  327.           and decimal precision and rounding.  You can set the precision
  328.           for a single calculation with the construct
  329.           %@EVAL[expression=x.y], where "x" specifies the minimum number of
  330.           decimal digits in the result, and "y" specifies the maximum.  To
  331.           set the default precision for all calculations see SETDOS /F and
  332.           the EvalMin and EvalMax directives in the .INI file.
  333.  
  334.    =>     @FILEOPEN has a third parameter; the new syntax is
  335.           %@FILEOPEN[filename,read|write|append[,b|t]], where "b" means
  336.           open in binary mode, and "t" means open in text mode.  Text mode
  337.           (the default) should be used to transfer text data with @FILEREAD
  338.           (without a read "length", see below) and @FILEWRITE.  Binary mode
  339.           should be used to transfer binary data with @FILEREAD (with a
  340.           read "length") and @FILEWRITEB.
  341.  
  342.    =>     @FILEREAD has an optional second parameter to set the number of
  343.           bytes to read.  The new syntax is @FILEREAD[n[,length]].  If the
  344.           length is not given the next line is read, as in the previous
  345.           version.
  346.  
  347.  
  348.  
  349.    4DOS 5.5  [10-12-94]           UPDAT55.DOC                        page 6
  350.  
  351.  
  352.    =>     @FILES, @FINDFIRST and @FINDNEXT now accept a dash [-] in the
  353.           attribute list.  The dash reverses the meaning of the following
  354.           attribute, for example "-d" means to include all entries except
  355.           subdirectories.
  356.  
  357.    => **  @FINDFIRST / @FINDNEXT have several changes:
  358.  
  359.               * Include lists are now supported.
  360.  
  361.               * The filename passed to @FINDNEXT is ignored, and the name
  362.               passed to the last @FINDFIRST is used instead.
  363.  
  364.               * The "." and ".." directories are no longer returned by
  365.               these functions.
  366.  
  367.    => **  @WORD has an optional new first argument; the new syntax is
  368.           @WORD[["xxx"],n,string], where "xxx" specifies the delimiters you
  369.           wish to use.  To include a double quote ["] within the delimiter
  370.           string, preface it with an escape character.
  371.  
  372.  
  373.    New Variable Functions:
  374.  
  375.    =>     @COMMA[n]:  Inserts commas (or the "thousands separator"
  376.           character for your country ID) into a numeric string.
  377.  
  378.    =>     @FILESEEKL[handle,line]:  Seeks to the specified line, allowing
  379.           you to do a subsequent @FILEREAD[] without having to loop through
  380.           the lines first.
  381.  
  382.    =>     @FILEWRITEB[handle,length,string]:  Writes the specified string
  383.           to the file; does not append a trailing CR/LF.
  384.  
  385.    =>     @FORMAT[[-][n][.n],string]:  Formats a string by padding or
  386.           truncating it to a specified length, with right or left
  387.           justification.
  388.  
  389.    =>     @IF[condition,true,false]:  Returns the "true" parameter if the
  390.           condition is true, or the "false" parameter if it is false.  The
  391.           conditions are the same as those for the IF command.  For
  392.           example, %@IF[2==2,Correct!,Oops!] will return "Correct!".
  393.  
  394.    =>     @MAKEAGE[date[,time]]:  Returns a number in the same format as
  395.           the %@FILEAGE function.  This allows you to compare the age of a
  396.           file to a specific date, for example:
  397.  
  398.                   if %@fileage[file1] lt %@makeage[10-1-94,12:00] echo Old!
  399.  
  400.    =>     @TIMER[n]:  Returns the current split time for the specified
  401.           timer started with the TIMER command.  "n" can be 1, 2, or 3.
  402.  
  403.  
  404.  
  405.  
  406.  
  407.    4DOS 5.5  [10-12-94]           UPDAT55.DOC                        page 7
  408.  
  409.  
  410.    =>     @WORDS[["xxx"],string]:  Returns the number of words in the
  411.           specified string.  The optional first argument is a list of
  412.           delimiters as in @WORD (see above).
  413.  
  414.  
  415.    New Internal Variables:
  416.  
  417.    =>     _BATCHLINE:  Returns the current line number in the current batch
  418.           file.  The first line is numbered one.
  419.  
  420.    =>     _BATCHNAME:  Returns the full path name of the current batch
  421.           file.
  422.  
  423.    =>     _DNAME:  Returns the name of the description file.  The default
  424.           is DESCRIPT.ION; the name can be changed with the DescriptionName
  425.           directive in the .INI file.
  426.  
  427.    =>     _DPMI:  Returns the DPMI version level, or 0 if DPMI isn't
  428.           present.
  429.  
  430.    =>     _KBHIT:  Returns 1 if a keystroke is waiting in the keyboard
  431.           buffer; 0 if not.
  432.  
  433.  
  434.    Technical and Compatibility Enhancements
  435.    ----------------------------------------
  436.  
  437.    =>     F1 will now skip past a leading "*" or "@" on the command line
  438.           when looking for the command name.  This allows you to use
  439.           context-sensitive help even when the command is prefaced with "*"
  440.           or "@".
  441.  
  442.    =>     Worked around an OS/2 bug to allow improved support for APPEND in
  443.           OS/2 DOS sessions.
  444.  
  445.  
  446.    Bugs Fixed
  447.    ----------
  448.  
  449.    =>     An INKEY /K would disable a wait (/W) once a key had been hit,
  450.           regardless of whether the key was in the /K list.
  451.  
  452.    =>     Batch file line prompting (SETDOS /Y1 and the new ? "xxx"
  453.           command) would prompt even if you were using a pipe and were
  454.           unable to respond.  Now it only prompts if input is coming from
  455.           the console.
  456.  
  457.    =>     Fixed a bug in 4DOS which would cause a crash in DIR or SELECT in
  458.           a very large directory with many descriptions.
  459.  
  460.    =>     Fixed a problem with multiple nested .AND.'s and .OR.'s in an IF
  461.           / IFF statement.
  462.  
  463.  
  464.  
  465.    4DOS 5.5  [10-12-94]           UPDAT55.DOC                        page 8
  466.  
  467.  
  468.    =>     SET /R and ALIAS /R line continuation did not always work
  469.           properly.
  470.  
  471.    =>     CTTY now works with Ctrl-S and Ctrl-C; destructive backspacing
  472.           also works; and critical errors come out in the right place.
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.    4DOS 5.5  [10-12-94]           UPDAT55.DOC                        page 9
  524.